Document gtk_application_get_menu_by_id

diff --git a/docs/reference/gtk/gtk3-overrides.txt b/docs/reference/gtk/gtk3-overrides.txt
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt
index 7b39805f236b811d7f5b6b81bb2a2fa04e81afd2..056e67de9e452a548e86ed108524519d969f3691 100644 (file)
--- a/docs/reference/gtk/gtk3-sections.txt
+++ b/docs/reference/gtk/gtk3-sections.txt
@@ -7398,6 +7398,7 @@ gtk_application_get_app_menu
 gtk_application_set_app_menu
 gtk_application_get_menubar
 gtk_application_set_menubar
+gtk_application_get_menu_by_id
 
 gtk_application_add_accelerator
 gtk_application_remove_accelerator

diff --git a/docs/reference/libgail-util/gail-libgail-util3-overrides.txt b/docs/reference/libgail-util/gail-libgail-util3-overrides.txt
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index e77cdc490aff9590470a84321cb5292325da8628..d2a8dad0d3fc30c151e2b2da76cdaa0204583a5f 100644 (file)
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -71,6 +71,8 @@
  * associated with #GtkApplicationWindow and to the “activate” and
  * 'open' #GApplication methods.
  *
+ * ## Automatic resources ## {#automatic-resources}
+ *
  * #GtkApplication will automatically load menus from the #GtkBuilder
  * file located at "gtk/menus.ui", relative to the application's
  * resource base path (see g_application_set_resource_base_path()).  The
@@ -1705,6 +1707,20 @@ gtk_application_handle_window_map (GtkApplication *application,
   gtk_application_impl_handle_window_map (application->priv->impl, window);
 }
 
+/**
+ * gtk_application_get_menu_by_id:
+ * @application: a #GtkApplication
+ * @id: the id of the menu to look up
+ *
+ * Gets a menu from automatically loaded resources.
+ * See [Automatic resources][automatic-resources]
+ * for more information.
+ *
+ * Returns: (transfer full): Gets the menu with the
+ *     given id from the automatically loaded resources
+ *
+ * Since: 3.14
+ */
 GMenu *
 gtk_application_get_menu_by_id (GtkApplication *application,
                                 const gchar    *id)